home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u258.dms / in.adf / UserDocs / Manual_Pages / Copy < prev    next >
Encoding:
Text File  |  1988-02-12  |  4.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      Copy(REL2)             ARP User's    Manual            Copy(REL2)
  5.  
  6.  
  7.  
  8.      NAME
  9.       Copy - Copy files
  10.  
  11.      SYNOPSIS
  12.       COPY FROM TO/A FLAGS/K ALL/S QUIET/S
  13.  
  14.      DESCRIPTION
  15.       COPY duplicates the contents of the file or files (if
  16.       wildcards are    used) of its FROM argument in the file or
  17.       directory specified in its TO    argument, over writing any
  18.       existing file    or files of the    same names.
  19.  
  20.       You may specify a directory name as the FROM argument, which
  21.       will cause COPY to copy all the files    in the FROM directory
  22.       to the destination directory.     The destination directory
  23.       must exist for the Copy to succeed.  If you do not specify a
  24.       FROM argument, the current directory will be used.
  25.  
  26.       The ARP Copy replacement also    allows you to specify the
  27.       Current directory as a destination without typing the    entire
  28.       path to the current directory.  To specify the current
  29.       directory as destination, simply use the '*' character as
  30.       the destination name.     You can also do a simple form of
  31.       rename as you    copy by    specifying an optional prefix and
  32.       postfix to the current directory shorthand.  The syntax is:
  33.  
  34.            <optional_prefix>*<optional_postfix>
  35.  
  36.       You may specify neither, one or both of these    optional tags.
  37.       Note that it is possible to exceed the length    of a legal
  38.       AmigaDOS filename (30    characters as of this writing).     If
  39.       this occurs, the name    will be    silently truncated.
  40.  
  41.       The behaviour    of COPY    may be modified    by using the following
  42.       switches:
  43.  
  44.       ALL -    this switch will cause Copy to duplicate the contents
  45.           of that entire branch    of the directory tree.    It
  46.           will recursively enter directories, creating them as
  47.           needed and duplicating their contents.  Without this
  48.           switch, only the first level of the directory
  49.           hierarchy will be duplicated.
  50.  
  51.       QUIET    - If you specify wildcards in the source, or if    you
  52.           use the ALL switch, copy will    be quite verbal    about
  53.           what it is copying or    creating.  If you find this
  54.           behaviour annoying, just specify the QUIET switch,
  55.           and only errors will be reported.
  56.  
  57.       FLAGS    - This is an ARP addition, not found in    the original
  58.           BCPL version of this program.     The Flags string
  59.           controls the copying of Filenotes, the original
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 2/22/88)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      Copy(REL2)             ARP User's    Manual            Copy(REL2)
  71.  
  72.  
  73.  
  74.           date,    and the    protect    bits.  The original BCPL
  75.           program just proceeded as though none    of these
  76.           existed.  You    can use    any of the following as    an
  77.           argument to Flags:
  78.  
  79.                 N      - copy FILENOTES
  80.                 C      - copy original DATESTAMP
  81.                 rweda - prevent these actions
  82.                 RWEDA - allow these    actions
  83.  
  84.           To copy the original protect flags, simply omit the
  85.           appropriate protect description. If you have
  86.           religious convictions    about any of the above,    see
  87.           the description of 'copyflags', below.
  88.  
  89.      ENVIRONMENT VARIABLES
  90.       Copy uses the    value of the environment variable 'copyflags',
  91.       if defined, in exactly the same way as the FLAGS keyword
  92.       described above.  This is useful if you don't    like the
  93.       default settings of Copy, since you can change them by
  94.       simply including a Set command in your startup script.  For
  95.       example, if you always want the original date    of your    files
  96.       preserved on a Copy, you can do a Set    copyflags=C to
  97.       effectively alter Copy's defaults.  Note however, that if
  98.       you do specify a FLAG's argument to Copy, it will override
  99.       the environment variables settings completely.
  100.  
  101.      EXAMPLES
  102.       SET copyflags=d    ; All copies are now protected from deletion.
  103.       COPY c: df1:c        ; All copied files are protected from deletion.
  104.  
  105.       COPY Include my*file
  106.       The above copies all files from the Include to the current
  107.       directory, prefixing each one    with 'my' and terminating each
  108.       one with 'file'.  So 'Include/LOST' becomes 'myLOSTfile' in
  109.       the current directory.
  110.  
  111.       Finally, notice that the following command (which copies
  112.       filenotes as well) will not protect the copied files from
  113.       deletion, in spite of    the earlier Set    copyflags=d we issued,
  114.       because the FLAGS argument overrides the environment
  115.       variable:
  116.  
  117.       Copy df0: to DF1: ALL    QUIET FLAGS N
  118.  
  119.       The above copies the entire contents of the disk in drive 0
  120.       to the disk in drive 1, silently, and    in addition also
  121.       copies the filenotes.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 2/22/88)
  130.  
  131.  
  132.  
  133.